home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Controls / Visual Basic Controls.iso / vbcontrol / vidhandl / readme.1st < prev    next >
Encoding:
Text File  |  1999-02-03  |  14.1 KB  |  355 lines
  1.               * * * * *  VIDEO HANDLING FUNCTIONS  * * * * *
  2.                                                  ver 2.0
  3.  
  4. Contents:
  5.  - Package Contents
  6.  - Introduction
  7.  - How to Install
  8.  - The VIDEO HANDLING FUNCTIONS (ON-LINE) Help
  9.  - The Source Code
  10.  - How to Uninstall
  11.  - Copyright
  12.  - How to Contact Me
  13.  
  14.  - - -                                                               - - -
  15.  
  16.                         * * * PACKAGE CONTENTS * * *
  17.  
  18.  
  19.    This package (CRT2_0.ZIP) contains the VIDEO HANDLING FUNCTIONS:
  20.      - Source code;
  21.      - Include file;
  22.      - Help file;
  23.      - Libraries;
  24.      - Examples/Development utilities with source;
  25.      - DEMO program with source;
  26.  
  27.    And also:
  28.      - EXTRAIA.EXE/MONTA.EXE => groups and ungroups C/C++ source files or any
  29.         text file. (UTIL\ subdir)
  30.      - DOSFONT => DOS character font edit and select utilities, plus some
  31.         example fonts. (DOSFONT\ subdir)
  32.  
  33.    The file FILELIST.TXT contains a list with a brief description of all files
  34.  stored in CRT2_0.ZIP.
  35.  
  36.  NOTICE:
  37.    Possibly in future versions, EXTRAIA/MONTA and DOSFONT will be published
  38.  in standalone packages.
  39.  
  40.  
  41.  
  42.  - - -                                                               - - -
  43.  
  44.                           * * * INTRODUCTION * * *
  45.  
  46.  
  47.    VIDEO HANDLING FUNCTIONS is a C/C++ library of functions for 16 bit DOS
  48.  environments (although they work fine in 32 bit DOS (that comes with WINDOWS
  49.  95/98)). They have been developed to provide an easy, but powerful and high
  50.  performance access to screen in text mode.
  51.    The main features of this library is:
  52.    - possibility to work in many video modes (including graphics modes)
  53.    - possibility to work in many video pages.
  54.    - possibly run in many video adapters (they work fine in CGA* and SVGA+)
  55.        *with some restrictions in CGA.
  56.    - almost as fast as assembly code. (when direct video RAM memory access is
  57.        enabled)
  58.    - in one function call specify the color and the position of text to be
  59.        written (no need to move cursor).
  60.    - create executable files compatible with almost all PC computers (since
  61.        very old PC to the latest Pentium II computers)
  62.    - Functions for:
  63.       - character/attribute read/write from screen
  64.       - string output on screen at a given position.
  65.       - string output on screen with special effects
  66.          (color change, any direction, justification,...)
  67.       - formatted output with special effects or standard
  68.       - screen/text-window painting.
  69.       - functions for drawing menu boxes / text boxes.
  70.       - screen/text-window saving/restoring with options or not.
  71.       - window relative functions.
  72.       - character shape (pattern) replacement.
  73.       - cursor shape resize, and cursor reposition.
  74.       - palette/overscan color/video DAC registers color change.
  75.       - video mode and video page change / detection
  76.       - detection of current video mode, active display page, number of
  77.           columns, rows, etc.
  78.       - miscellaneous EGA/VGA functions.
  79.  
  80.    - Over 60 functions and many macro functions occupying all together only 6.4
  81.    kbytes in small memory model. All with source code and examples.
  82.  
  83.    Extensive documentation and examples are found in DOC\VIDEOHLP.TXT
  84.  help file. VIDEOHLP.TXT is in Borland C++ 3.0 Help style and requires
  85.  Helppc 2.10 to be browsed (it is, to be on-line). However VIDEOHLP.TXT is
  86.  also readable in common text editors.
  87.  
  88.     Why 16 bit version instead of a 32 bit?
  89.      - 16 bit versions works in almost every computer (since very old PC
  90.        dinosaurs to latest computers).
  91.      - Can be supervised by 32 bit protected mode programs such as Windows
  92.      - I don't have a 32 bit compiler.
  93.  
  94.    I didn't have time to get a newer compiler and to port it to 32 bit.
  95.  But you are encouraged to port it to 32 bit and to distribute it with another
  96.  name. (If you do so, please tell me, so I will be able to inform other users
  97.  about your version).
  98.    You may try also to port it to DJGPP, a freeware 32 bit development
  99.  environment.
  100.  
  101.    NOTICE: Probably I will not have anymore time to continue the development
  102.  of these functions, so if you are interested in continuing my work, please
  103.  contact me sending an E-mail, and them I will reply, instructing what you
  104.  have to do. (see at the end of this file How to Contact Me)
  105.  
  106.  
  107.  
  108.  - - -                                                               - - -
  109.  
  110.                          * * * HOW TO INSTALL * * *
  111.  
  112.  
  113.    The VIDEO HANDLING FUNCTIONS are compiled and grouped in libraries (see
  114.  FILELIST.TXT), one for each memory model.
  115.    The libraries have been compiled with the aid of \SOURCE\VIDEO.PRJ and with
  116.  options SUPRESS REDUNDANT LOADS (-Z in TCC) and JUMP OPTIMIZATION (-O in TCC)
  117.  switched on. All comment records and debug information have been purged from
  118.  libraries to reduce file size. The compiler was Turbo C++ 3.0 IDE. (See at
  119.  the end of file SOURCE\README.TXT for more information about the libraries).
  120.  
  121. BEFORE INSTALLATION:
  122.  
  123.   Go to the subdirectory where you unzipped CRT2_0.ZIP, there should exist
  124.  the subdirectories LIB\ INCLUDE\ and DOC\. If these directories don't exist,
  125.  unzip CRT2_0.ZIP with -d option (with pkunzip) to restore original directory
  126.  structure. You may try also Winzip (be sure that USE FOLDER NAME option is
  127.  checked), or another extractor.
  128.  
  129. IF YOU ARE USING TURBO C/C++:
  130.      From the DOS prompt:
  131.  In the subdirectory where you unzipped CRT2_0.ZIP, type
  132.  
  133.    INSTALL <Turbo C/C++ path>
  134.  
  135.  for example:
  136.  
  137.    INSTALL C:\TC
  138.  
  139. IF YOU ARE USING BORLAND C/C++ or compatible:
  140.    Verify if the librarian name is TLIB. If it's not edit INSTALL.BAT and
  141.  replace every occurrence of TLIB by your compiler's librarian name.
  142.  After run INSTALL.BAT with the path of your C/C++ compiler.
  143.  
  144. IF YOU ARE USING ANOTHER C/C++ COMPILER that is not compatible with libraries
  145. in LIB\ subdir.
  146.    Port the source code files stored in SOURCE to your compiler.
  147.    The source code of these functions is stored in a large archive named
  148.  VIDEO.SRC, extract files from VIDEO.SRC using EXTRAIA utility, located at
  149.  the same subdir. For more information on how to extract the source code
  150.  of these function, read README.TXT also located in the same subdir.
  151.  
  152. DOING BY HAND:
  153.    If you desire, you may install by hand.
  154.  
  155.  The header file is:              INCLUDE\CRT.H
  156.  The libraries are located at:    LIB\    (each file for each memory model)
  157.  The Help file is:                DOC\VIDEOHLP.TXT
  158.  
  159.  
  160. IMPORTANT: INSTALL.BAT doesn't installs the VIDEO HANDLING FUNCTIONS help in
  161. such a way it becomes On-line. It simply copies the help file (VIDEOHLP.TXT)
  162.  to \DOC subdirectory of your C/C++ compiler.
  163.  
  164.  
  165.  
  166.  - - -                                                               - - -
  167.  
  168.  
  169.            * * * THE VIDEO HANDLING FUNCTIONS (ON-LINE) HELP * * *
  170.  
  171.  
  172.    The Help file located in DOC\ subdirectory and named VIDEOHLP.TXT is
  173.  in Helppc 2.10 format. To be browsed (it is, to be On-line) it requires
  174.  Helppc ver 2.10 or better. However VIDEOHLP.TXT is a common text file also
  175.  being readable by common text editors.
  176.    HelpPC is a shareware program written by David Jurgens, it's available on
  177.  the Internet at SimtelNet and it's mirrors at:
  178.  http://www.simtel.net/simtel.net/msdos/info.html (as helppc21.zip)
  179.    or at
  180.  ftp://ftp.cdrom.com/pub/simtelnet/msdos/info/helppc21.zip
  181.  
  182.    VIDEOHLP.TXT is in Borland Turbo C++ 3.0 style, being familiar to
  183.  Borland or Turbo C/C++ programmers.
  184.  
  185.    To turn it into an On-Line help, read DOC\ONLINE.TXT
  186.  
  187.    To convert VIDEOHLP.TXT to other help formats, read DOC\CONVERT.TXT
  188.  
  189. - - -                                                                - - -
  190.  
  191.  
  192.                        * * * THE SOURCE CODE * * *
  193.  
  194.  
  195.    The source code of all functions is available at SOURCE\ subdir, stored in
  196.  VIDEO.SRC archive. To see how to extract source code from VIDEO.SRC and how
  197.  to compile the functions to build libraries, read SOURCE\README.TXT.
  198.  
  199.    The source code was developed with Turbo C++ 3.0
  200.  
  201.    VIDEO.SRC is an ASCII file, being editable by common text editors.
  202.  
  203.  
  204.  
  205. - - -                                                                - - -
  206.  
  207.                        * * * HOW TO UNISTALL * * *
  208.  
  209.  
  210.  
  211. IF YOU ARE USING TURBO C/C++:
  212.      From the DOS prompt:
  213.  In the subdirectory where you unzipped CRT2_0.ZIP, type
  214.  
  215.    REMOVE <Turbo C/C++ path>
  216.  
  217.  for example:
  218.  
  219.    REMOVE C:\TC
  220.  
  221. IF YOU ARE USING BORLAND C/C++ or compatible:
  222.    Verify if the librarian name is TLIB. If it's not edit REMOVE.BAT and
  223.  replace every occurrence of TLIB by your compiler's librarian name.
  224.  After run REMOVE.BAT with the path of your C/C++ compiler.
  225.  
  226. IF YOU ARE USING ANOTHER C/C++ COMPILER OR DOING BY HAND:
  227.    Locate the files below and remove them:
  228.  
  229.       CRT.H => Header File
  230.       VIDEOHLP.TXT => The VIDEO HANDLING FUNCTIONS Help
  231.  
  232.    If you've installed the functions in your compiler RTL libraries, remove
  233.  the VIDEO HANDLING FUNCTIONS modules using your librarian. The file
  234.  REMOVE.DAT has a listing of all modules included.
  235.  
  236.  
  237.  
  238. - - -                                                                - - -
  239.  
  240.                           * * * COPYRIGHT * * *
  241.  
  242.  
  243.    The copyright notes below refer to VIDEO HANDLING FUNCTIONS and all other
  244.  programs and examples included in this package(CRT2_0.ZIP).
  245.  
  246.    This software is classified as FREEWARE and the ideas comprised here
  247.  (including algorithms used by the functions) are on PUBLIC DOMAIN. That means
  248.  you can FREELY distribute and get this software, but I still retain some
  249.  rights over it.
  250.  
  251.    It's prohibited to sell this software or parts of it, but I allow to
  252.  include it in collections or softwares that are sold, and also to charge
  253.  some fee for the material used in distribution (diskettes,CD-ROM,etc), and
  254.  for handling/shipping operations. This restriction doesn't apply for works
  255.  based in this software (including modified versions)
  256.  
  257.    Distribute preferably the package in it's original form. But permission is
  258.  granted to create modified versions of it, or to distribute it/parts of it
  259.  in other formats provided that:
  260.    - You use another name in your package, so my users will know that it was
  261.      done by another person. (for example VIDCRT instead of CRT)
  262.      But if you port it to other programming languages you can use similar
  263.      names (but not the same) (for example CRT++)
  264.      NOTE ABOUT THE NAME: The name of the package is CRT, CRT2_0 is the name
  265.      of the package plus the version (in this case version 2.0)
  266.  
  267.    - You must state the changes you've done and write your name as the author
  268.      of modifications.
  269.  
  270.    - You must give some kind of credit to me, including my name and where
  271.      your user can find this software (including my E-mail and homepage is
  272.      not essential, but it would be nice)
  273.  
  274.    The above restrictions doesn't apply for programs that only uses the
  275.  functions that have been linked or compiled to the program or .FNT files
  276.  stored in \DOSFONT\ subdirectory.
  277.  
  278.    You may not use it to harm or disturb mankind. And please do not use it
  279.  for evil purposes.
  280.  
  281. DISCLAIMER:
  282. THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  283. EITHER EXPRESSED OR IMPLIED. THE ENTIRE RISK AS TO THE QUALITY
  284. AND PERFORMANCE OF THE PRODUCT IS WITH YOU. SHOULD THE PRODUCT
  285. PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
  286. REPAIR OR CORRECTION.
  287.  
  288. IN NO EVENT WILL BE THE AUTHOR, OR ANY OTHER PARTY WHO MAY HAVE
  289. REDISTRIBUTED THE PRODUCT, BE LIABLE TO YOU FOR
  290. DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
  291. CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
  292. THE PRODUCT (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
  293. BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
  294. PARTIES OR A FAILURE OF THE PRODUCT TO OPERATE WITH ANY OTHER
  295. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF
  296. THE POSSIBILITY OF SUCH DAMAGES.
  297.  
  298.    I've done my best, but I can't guarantee that it's free of errors or
  299.  that it will work fine in a particular system. If anything occurs, please
  300.  report it to me. Anyway telling me the defects of my work will prevent
  301.  future versions from failing or causing disaster in other users system.
  302.  I would be glad to receive messages telling any error.
  303.  
  304.    Any patent registered in the world about this software will be void, as it
  305.  is distributed freely worldwide.
  306.  
  307.  Copyright (c) 1998,1999 by Márcio Afonso Arimura Fialho.
  308.  
  309.  
  310. CREDITS:
  311.  
  312.    Thanks to Ralf Brown and everyone who has helped me to develop these
  313.  functions, without their help it would be impossible.
  314.  
  315.  Bibliography:
  316.   - Ralf Brown's Interrupt list:
  317.       http://www.cs.cmu.edu/afs/cs/user/ralf/pub/WWW/files.html
  318.       ralf@pobox.com
  319.     Ralf Brown's Interrupt list: => alternate sites, main site above
  320.         http://www.simtel.net/msdos/info.html
  321.         http://oak.oakland.edu/msdos/info.html => mirror of Simtel Net
  322.         ftp://ftp.cdrom.com/pub/simtelnet/msdos/info/interRRA.ZIP
  323.                                                      interRRB.ZIP
  324.                                                         .
  325.                                                         .
  326.                                                         .
  327.                                                      interRRG.ZIP
  328.           RR is the release number (at the time I wrote this, RR was 60).
  329.  
  330.   - Turbo C++ Completo e Total
  331.   - Other sources.
  332.  
  333.    Thanks also for David Jurgens, who has created HelpPc, a very simple and
  334.  useful help browser (although it has very few resources, it helps a lot).
  335.    ftp://ftp.cdrom.com/pub/simtelnet/msdos/info/helppc21.zip
  336.  
  337.  
  338.  
  339. - - -                                                                - - -
  340.  
  341.                        * * * HOW TO CONTACT ME * * *
  342.  
  343.  
  344.    Any doubt's, suggestions, complains, enhancements you may have in mind,
  345.  please report them to me, or at least tell me what you think about the
  346.  programs comprised in CRT2_0.ZIP.
  347.  
  348.  Author: Márcio Afonso Arimura Fialho
  349.  Email: jlfialho@iconet.com.br
  350.  Home page: http://pessoal.iconet.com.br/jlfialho
  351.  Version: 2.0 of 1999.02.04 (year.month.day)
  352.  
  353.  P.S.:If you can't access my homepage, e-mail me, reporting the problem.
  354.       If you can't access my E-mail, use my father's e-mail:
  355.          jlfialho@yahoo.com